home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / bkck.arc / BKCK.DOC next >
Encoding:
Text File  |  1988-04-10  |  7.1 KB  |  211 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.       Program: BKCK.EXE
  8.       Version: Version 2.1
  9.       Date: April 10, 1988
  10.  
  11.  
  12.       Usage:
  13.                BKCK [filespec] [switches]
  14.        
  15.           Filespec
  16.             the same as with the DOS DIR command 
  17.        
  18.           Switches
  19.             /A    Check all disk drives on system 
  20.             /F    Display filenames only (suppress size, date, & time info)
  21.             /P    Pause mode - after each screen 
  22.             /T    Display totals only (summary) 
  23.             /DT   Suppress summary of each directory 
  24.             /S    Check subdirectories also 
  25.             /TT   Same as /S/DT/T all together 
  26.             /A:mm-dd-yy to specify files changed AFTER date 
  27.  
  28.       Notes:
  29.           Enter "BKCK ?" to get a display of these commands.
  30.  
  31.           The AFTER switch checks only files changed after the specified
  32.           date. Not to be confused with "on or after" the date, only
  33.           "after" the date.
  34.  
  35.           When using the /A switch to check all drives, it automatically
  36.           assumes the root directory and the /S switch.
  37.  
  38.           I added the /TT because I like to get a total summary for my
  39.           entire disk without seeing all the files and subdirectory totals,
  40.           and I get tired of typing /S/DT/T every time.
  41.  
  42.           Hint:  I use this program to get a directory listing of only the
  43.           latest files in a directory.  This is useful if you have a large
  44.           directory and want to see the few files you have just downloaded
  45.           (for example), without having to sift through the long list
  46.           generated by the DOS DIR command.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.                       BKCK.EXE - Version 2.1 by John Crouch
  53.  
  54.  
  55.  
  56.       INTRODUCTION
  57.  
  58.       BKCK will give information about files on your hard disk that need
  59.       backing up.  It will display only those files which have their
  60.       archive bit set.
  61.  
  62.       SYSOPS and other people with multiple drives will like the /A option. 
  63.       It will check all drives on your system and give a summary for each
  64.       drive, and a summary for all drives combined.  In future versions I
  65.       would like to make this feature recognize SUBSTitute and ASSIGNed
  66.       drives and skip over them.  However, at this time I have not been
  67.       able to find a reliable method to determine these types of
  68.       configurations; there are no documented DOS functions for this
  69.       purpose.  I'm sorry for any inconvenience this may cause you, but
  70.       until I can find a reliable method for detecting these types of
  71.       drives we must live with this problem.
  72.  
  73.       For a hard copy of the information supplied by BKCK, use the
  74.       redirection command to redirect the output to the printer: BKCK >PRN
  75.  
  76.  
  77.       A MAJOR CHANGE IN THE ERRORLEVEL RETURNED:
  78.  
  79.       BKCK will return an errorlevel for checking in a batch file.  
  80.       Previous versions returned an errorlevel based on the number of files
  81.       which needed backing up on the disk.  THE ERRORLEVEL RETURNED WITH
  82.       THIS VERSION IS BASED ON THE PERCENTAGE OF DATA NEEDING TO BE BACKED
  83.       UP.  The percentage of data needing backed up is rounded to the
  84.       nearest integer and returned as the errorlevel.  If an error occurs
  85.       while running the program, the errorlevel returned is 255.  An
  86.       example of how this can be checked in a batch file follows:
  87.  
  88.  
  89.       IF ERRORLEVEL 255 GOTO PROGERROR
  90.       IF ERRORLEVEL 50 GOTO TOOMUCH
  91.       ECHO Less than 50 percent of your data needs backing up.
  92.       GOTO END
  93.  
  94.       :TOOMUCH
  95.       ECHO MORE THAN 50 PERCENT OF YOUR DATA NEEDS BACKING UP.
  96.       ECHO ITS TIME TO DO A BACKUP!
  97.       REM  A COMMAND TO RUN YOUR BACKUP PROGRAM BE INSERTED START HERE.
  98.       GOTO END
  99.  
  100.       :PROGERROR
  101.       ECHO AN ERROR HAS OCCURRED WHILE RUNNING THE PROGRAM.
  102.  
  103.       :END
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                       BKCK.EXE - Version 2.1 by John Crouch
  112.  
  113.  
  114.  
  115.       TECHNICAL INFORMATION
  116.  
  117.       The BKCK program was written and compiled with Borland's TurboC,
  118.       Version 1.5.  Many specific functions were created in C and Assembly
  119.       language.  Assembly language routines were assembled with the
  120.       Microsoft Macro Assembler, Version 5.0.  The Norton Editor was used
  121.       for most of the program editing.
  122.  
  123.  
  124.       VERSION INFORMATION
  125.  
  126.       Version 1.0 -
  127.           was (of course) the first release. It was written entirely in
  128.           assembly language. This program was blazing fast, but with little
  129.           features.
  130.  
  131.       Version 1.1 -
  132.           woops... fixed a minor bug in this one. One user found that it
  133.           would not work properly with hidden subdirectories.  Also added
  134.           the feature to use the environment SET command to force the
  135.           program not to use the 8087 co-processor.
  136.  
  137.       Version 2.0 -
  138.           completely redone in Borland's TurboC.  This version is slightly
  139.           slower than the assembly language version, but contains many new
  140.           options, like allowing you to specify file names, check all
  141.           drives, etc.
  142.  
  143.       Version 2.1 - 
  144.           added a few more options and fixed some minor bugs. The AFTER
  145.           switch was added (as requested by a user) to allow checking files
  146.           changed after a certain date, and the errorlevel returned was
  147.           changed to be a percentage instead of a file count.
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.                       BKCK.EXE - Version 2.1 by John Crouch
  156.  
  157.  
  158.  
  159.       PLEASE CONTRIBUTE!!
  160.  
  161.       Programmers need your comments and suggestions concerning their
  162.       programs.  Without these comments, programs might never be updated. 
  163.       Let me hear what you think about this program, and encourage more
  164.       programs by giving contributions.  There are many very good products
  165.       available on BBS systems today.  So if you find this program useful,
  166.       please send a $15 contribution to the address below.
  167.  
  168.       I would like to thank all the people who have sent contributions and
  169.       suggestions.  Those of you know who you are, and will recognize that
  170.       some of those suggestions have been incorporated into this version of
  171.       BKCK.
  172.  
  173.       Send suggestions for this program, and new ideas for other programs
  174.       to one of the following locations:
  175.  
  176.  
  177.                                    John Crouch
  178.                                   P.O. Box 1521
  179.                             Frederick, Maryland 21701
  180.  
  181.                             -------------------------
  182.  
  183.               CompuServe EasyPlex Mail     The New Micro Connection BBS
  184.                     71310,2612                    (301) 698-0212
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.                       BKCK.EXE - Version 2.1 by John Crouch
  193.  
  194.  
  195.  
  196.  
  197.       DISCLAIMER
  198.  
  199.       This code is released into the public domain with two restrictions as
  200.       to its use.
  201.  
  202.       1.  The program must not be modified in any way.
  203.       2.  The program must not be sold.  
  204.  
  205.       The author has taken due care in writing this code, and the code is
  206.       supplied as is.  The author makes no expressed or implied warranty of
  207.       any kind with regard to this code.  In no event shall the author be
  208.       liable for incidental or consequential damages in connection with or
  209.       arising out of the use of this code.
  210.  
  211.